home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiofile / afSetLoopStartFrame.z / afSetLoopStartFrame
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrttttFFFFrrrraaaammmmeeee((((3333ddddmmmm))))                              aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrttttFFFFrrrraaaammmmeeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afSetLoopStartFrame, afSetLoopEndFrame, afSetLoopCount - set the
  10.      start/end frame and loop count from an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure for a
  11.      specified loop.
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  15.  
  16.      iiiinnnntttt aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrttttFFFFrrrraaaammmmeeee((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt iiiinnnnssssttttiiiidddd,,,,
  17.                                   iiiinnnntttt llllooooooooppppiiiidddd,,,, AAAAFFFFffffrrrraaaammmmeeeeccccoooouuuunnnntttt ssssttttaaaarrrrttttffffrrrraaaammmmeeee))))
  18.  
  19.      iiiinnnntttt aaaaffffSSSSeeeettttLLLLooooooooppppEEEEnnnnddddFFFFrrrraaaammmmeeee((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt iiiinnnnssssttttiiiidddd,,,,
  20.                                   iiiinnnntttt llllooooooooppppiiiidddd,,,, AAAAFFFFffffrrrraaaammmmeeeeccccoooouuuunnnntttt eeeennnnddddffffrrrraaaammmmeeee))))
  21.  
  22.      iiiinnnntttt aaaaffffSSSSeeeettttLLLLooooooooppppCCCCoooouuuunnnntttt((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt iiiinnnnssssttttiiiidddd,,,,
  23.                                   iiiinnnntttt llllooooooooppppiiiidddd,,,, iiiinnnntttt ccccoooouuuunnnntttt))))
  24.  
  25. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  26.      _f_i_l_e     is an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure, previously created by a call to
  27.               aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  28.  
  29.      _i_n_s_t_i_d   is a positive integer value which identifies an instrument
  30.               configuration in _f_i_l_e.  _i_n_s_t_i_d should be an element from an
  31.               array of IDs created via a call to aaaaffffIIIInnnniiiittttIIIInnnnssssttttIIIIDDDDssss(3dm).
  32.  
  33.      _l_o_o_p_i_d   is a positive integer value which identifies a loop structure in
  34.               an instrument parameter chunk.  You create _l_o_o_p_i_d's by calling
  35.               aaaaffffIIIInnnniiiittttLLLLooooooooppppIIIIDDDDssss(3dm).
  36.  
  37. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  38.      All of these routines return 0 on success or -1 if there is an error.
  39.  
  40. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.      Each takes a _l_o_o_p_i_d argument which provides a handle to a set of loop
  42.      parameters.
  43.  
  44.      You can create a list of loop ID's for an audio track by calling
  45.      aaaaffffIIIInnnniiiittttLLLLooooooooppppIIIIDDDDssss(3dm).  Logically, an audio file contains chunks of
  46.      instrument parameters (specified by _i_n_s_t_i_d handles), and each chunk of
  47.      instrument parameters may contain several loops.
  48.  
  49.      AAAAIIIIFFFFFFFF(4) (and AIFF-C) files contain at most one instrument configuration,
  50.      but other file formats may contain multiple configurations.  aaaaffffQQQQuuuueeeerrrryyyy(3dm)
  51.      should be used to determine in advance whether a particular format
  52.      supports multiple inst chunks.
  53.  
  54.      These routines allow you to set information about loops in an audio file
  55.      without the added overhead of using associated markers (see
  56.      aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrtttt(3dm)).  This is necessary because several file formats now
  57.      supported by the Audio File Library contain loop information (i.e., start
  58.      and end points) which is completely independent of marker information.
  59.      In other words, the markers (if any) stored in the file header may and
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrttttFFFFrrrraaaammmmeeee((((3333ddddmmmm))))                              aaaaffffSSSSeeeettttLLLLooooooooppppSSSSttttaaaarrrrttttFFFFrrrraaaammmmeeee((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      usually will refer to locations in the file other than the loop start and
  75.      end points.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      afOpenFile(3dm), afInitInstIDs(3dm), afSetInstParamLong(3dm),
  79.      afInitLoopIDs(3dm), afSetLoopStart(3dm), aiff(4), avr(4), wave(4), sd2(4)
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.